feat: add native Cline integration by pedropalb · Pull Request #2508 · github/spec-kit

pedropalb · 2026-05-09T16:13:05Z

Description

This PR introduces a new integration for Cline (IDE-based agent).

New Cline Integration: Added a dedicated integration for Cline in src/specify_cli/integrations/cline/. It uses the .clinerules/ directory and defaults to hyphenated command invocations (e.g., /speckit-plan) which Cline handles optimally.
Unified Naming Convention: Refactored CommandRegistrar to respect a format_name callback in integration configurations. This unifies naming for hyphenated agents so that even extension commands (e.g., those from the git extension) use hyphenated filenames (e.g., speckit-git-feature.md) instead of dot-notation.
Hook Rendering Update: Updated HookExecutor to correctly render hyphenated invocations for Cline projects.
Documentation: Added Cline to the supported integrations documentation.
Forge Compatibility: Updated Forge test expectations to reflect the new unified naming convention for extension commands.

Testing

Tested locally with uv run specify --help
Ran existing tests with uv sync && uv run pytest
Tested with a sample project (if applicable)

AI Disclosure

I did not use AI assistance for this contribution
I did use AI assistance (describe below)

Code generated with Gemini CLI with little manual tunings.

Copilot

Pull request overview

Adds first-class support for the Cline IDE agent integration, while generalizing command name formatting so integrations can control on-disk command naming (notably for hyphenated slash-command agents). Also updates hook invocation rendering and adjusts tests/docs accordingly.

Changes:

Introduce ClineIntegration targeting .clinerules/ with hyphenated command filenames and invocations.
Update CommandRegistrar to respect an integration-provided format_name callback for non-skill command file output names.
Render hyphenated invocations for Cline in hook execution and update tests/docs/catalog to include the new integration.

Show a summary per file

File	Description
tests/test_extensions.py	Adds coverage for Cline-specific hook invocation rendering (`/speckit-*`).
tests/integrations/test_integration_subcommand.py	Normalizes CLI output assertions by stripping ANSI codes.
tests/integrations/test_integration_forge.py	Updates Forge expectations for hyphenated extension command filenames.
tests/integrations/test_integration_cline.py	Adds new test suite for Cline integration behavior and naming.
tests/integrations/test_cli.py	Strips ANSI codes before asserting on Rich CLI output.
src/specify_cli/integrations/cline/init.py	Implements the new Cline integration + command name formatter.
src/specify_cli/integrations/init.py	Registers Cline as a builtin integration.
src/specify_cli/extensions.py	Updates hook invocation rendering to emit `/speckit-*` for Cline projects.
src/specify_cli/agents.py	Applies `format_name` when computing non-skill on-disk command filenames.
integrations/catalog.json	Adds Cline metadata to the integrations catalog.
docs/reference/integrations.md	Documents Cline as a supported integration.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Files reviewed: 11/11 changed files
Comments generated: 3

Copilot

Copilot's findings

Files reviewed: 11/11 changed files
Comments generated: 3

mnriem · 2026-05-12T16:17:24Z

Please address Copilot feedback

Copilot

Copilot's findings

Files reviewed: 11/11 changed files
Comments generated: 1

mnriem

Please address Copilot feedback

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copilot

Copilot's findings

Files reviewed: 12/12 changed files
Comments generated: 2

mnriem · 2026-05-13T21:57:37Z

Please address Copilot feedback. If not applicable please explain why. Also please resolve conflicts by pulling in latest from upstream/main

Copilot

Copilot's findings

Files reviewed: 12/12 changed files
Comments generated: 0 new

pedropalb · 2026-05-22T12:33:52Z

Recent changes:

I pushed some improvements to Cline integration addressing hyphenization of:
- Hardcoded commands in markdown templates.
- Commands in handoffs of markdowns frontmatters.
- Commands representation in CLI display.
Also, I ran code review locally using Claude Opus 4.6 through Antigravity CLI, and addressed its suggestions.

Copilot

Copilot's findings

Files reviewed: 13/13 changed files
Comments generated: 2

mnriem · 2026-05-27T12:31:10Z

Please address Copilot feedback and resolve conflicts

mnriem

Please see comments above

Copilot

Copilot's findings

Files reviewed: 14/14 changed files
Comments generated: 1

mnriem

Please address Copilot feedback

pedropalb marked this pull request as ready for review May 9, 2026 19:18

pedropalb requested a review from mnriem as a code owner May 9, 2026 19:18

mnriem requested a review from Copilot May 11, 2026 19:34

Copilot started reviewing on behalf of mnriem May 11, 2026 19:34 View session

Copilot AI reviewed May 11, 2026

View reviewed changes

Comment thread src/specify_cli/integrations/cline/__init__.py

Comment thread src/specify_cli/integrations/cline/__init__.py

Comment thread tests/integrations/test_integration_cline.py

pedropalb force-pushed the cline-integration branch from 2d0db2c to 03ba965 Compare May 12, 2026 10:52

mnriem requested a review from Copilot May 12, 2026 14:49

Copilot started reviewing on behalf of mnriem May 12, 2026 14:50 View session

Copilot AI reviewed May 12, 2026

View reviewed changes

Comment thread src/specify_cli/agents.py

Comment thread tests/integrations/test_integration_cline.py Outdated

Comment thread integrations/catalog.json

pedropalb force-pushed the cline-integration branch from 03ba965 to d098c2d Compare May 12, 2026 17:23

mnriem requested a review from Copilot May 12, 2026 17:34

Copilot started reviewing on behalf of mnriem May 12, 2026 17:34 View session

Copilot AI reviewed May 12, 2026

View reviewed changes

Comment thread src/specify_cli/agents.py

mnriem requested changes May 12, 2026

View reviewed changes

mnriem requested a review from Copilot May 13, 2026 21:26

Copilot AI reviewed May 13, 2026

View reviewed changes

pedropalb force-pushed the cline-integration branch from 1b9a0f1 to 83b6c3e Compare May 13, 2026 21:27

mnriem requested a review from Copilot May 13, 2026 21:38

Copilot started reviewing on behalf of mnriem May 13, 2026 21:39 View session

Copilot AI reviewed May 13, 2026

View reviewed changes

Comment thread src/specify_cli/extensions.py

Comment thread src/specify_cli/agents.py Outdated

pedropalb force-pushed the cline-integration branch 4 times, most recently from 49aabc9 to 4552440 Compare May 17, 2026 17:31

pedropalb requested a review from mnriem May 17, 2026 17:34

pedropalb force-pushed the cline-integration branch from 4552440 to e0bbbbf Compare May 20, 2026 13:08

mnriem requested a review from Copilot May 21, 2026 12:33

Copilot started reviewing on behalf of mnriem May 21, 2026 12:33 View session

Copilot AI reviewed May 21, 2026

View reviewed changes

pedropalb force-pushed the cline-integration branch 3 times, most recently from 3a8f905 to fe38e40 Compare May 22, 2026 10:22

mnriem requested a review from Copilot May 26, 2026 15:56

Copilot started reviewing on behalf of mnriem May 26, 2026 15:56 View session

Copilot AI reviewed May 26, 2026

View reviewed changes

Comment thread src/specify_cli/extensions.py

Comment thread src/specify_cli/agents.py Outdated

mnriem requested changes May 27, 2026

View reviewed changes

pedropalb force-pushed the cline-integration branch from 3af267b to 61d00aa Compare May 28, 2026 10:48

pedropalb requested a review from mnriem May 28, 2026 10:48

mnriem requested a review from Copilot May 28, 2026 13:48

Copilot started reviewing on behalf of mnriem May 28, 2026 13:48 View session

Copilot AI reviewed May 28, 2026

View reviewed changes

Comment thread src/specify_cli/agents.py

mnriem requested changes May 28, 2026

View reviewed changes

test: strip ansi to make asserts work

b7f0716

pedropalb force-pushed the cline-integration branch 2 times, most recently from ae7bfa1 to 3a04ea8 Compare May 29, 2026 00:10

pedropalb requested a review from mnriem May 29, 2026 00:11

feat: add native Cline integration

3a04ea8

Conversation

pedropalb commented May 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Testing

AI Disclosure

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mnriem commented May 12, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

mnriem commented May 13, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

pedropalb commented May 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

mnriem commented May 27, 2026

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

pedropalb commented May 9, 2026 •

edited

Loading

pedropalb commented May 22, 2026 •

edited

Loading